home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / pp / pp-6.0 / pp-changes.ms < prev    next >
Encoding:
Text File  |  1991-12-18  |  12.1 KB  |  307 lines
  1. .\" $Header: /xtel/pp/pp-beta/RCS/pp-changes.ms,v 6.0 1991/12/18 20:02:50 jpo Rel $
  2. .\"
  3. .\" $Log: pp-changes.ms,v $
  4. .\" Revision 6.0  1991/12/18  20:02:50  jpo
  5. .\" Release 6.0
  6. .\"
  7. .\"
  8. .\"
  9. .ds Pv 6.0
  10. .ds Lv 5.2
  11. .ds Iv 7.0
  12. .ds Il 6.0
  13. .ds Ii 6.8
  14. .de Bu
  15. .IP \(bu
  16. ..
  17. .de Ip
  18. .IP "\fB\\$1\fP\0\0"
  19. ..
  20. .TL
  21. Changes from PP version \*(Lv to \*(Pv
  22. .NH
  23. Overview
  24. .LP
  25. This short document is a description of the more user/administrator
  26. visible changes that have taken place in PP between the last interim
  27. version (\*(Lv) and the beta version (\*(Pv). This document is not
  28. exhaustive or complete but is a guide to what to look out for. In
  29. general the following may be assumed.
  30. .Bu
  31. The Queue files are compatible between \*(Lv and \*(Pv.
  32. Note however that the Queue structure has changed. Old channels will
  33. have to be recompiled to recognise the new format, but new channels
  34. will read old queue files.
  35. .Bu
  36. The qmgr protocol is compatible between \*(Lv and \*(Pv
  37. .Bu
  38. The syntax of some of the table files has changed. Where appropriate
  39. conversion scripts are provided.
  40. .Bu
  41. Some procedure calls have been changed or have different parameters.
  42. .Bu
  43. the libdsap.a library is now required for compilation.
  44. .LP
  45. In summary, you should be careful when upgrading to the \*(Pv release.
  46. It will not work by just replacing the \*(Lv binaries with \*(Pv. For
  47. definite the domain table will HAVE to be changed.
  48. .NH
  49. Detailed changes
  50. .LP 
  51. This list is in no particular order of preference or importance.
  52. .Ip "Domain Table"
  53. The domain table syntax has been changed to be more explicit and has
  54. been brought into line with the OR table syntax. We feel this is
  55. clearer and more logical. Tools that process the domain table have
  56. been taught the new format and there are scripts in
  57. Tools/tables/compat to convert between the old and new formats.
  58. There is \fBNO\fP backwards compatibility here. Old format tables will
  59. just plain not work.
  60. .Ip "Aliases Table"
  61. The aliases table syntax has changed to a main choice of
  62. synonym or alias with further qualifiers specifying
  63. the address type of the synonym or alias.
  64. The changes are
  65. .sp
  66. .in +5
  67. .nf
  68. .ta +\w'x:x400-synonym y\0\0'u
  69. x:alias y    x:alias y
  70. x:synonym y    x:synonym y
  71. x:822-synonym y    x:synonym y 822
  72. x:x400-synonym y    x:synonym y x400
  73. x:822 y        x:alias y 822
  74. x:x400 y    x:alias y x400
  75. .fi
  76. .in -5
  77. where any white space in y must be quoted using a backslash
  78. There is also a "external" qualifier.
  79. This disables further lookups of synonyms and aliases and can be used
  80. for a main site mail hub mapping from site_wide_name@localsite to
  81. local_machine_name@localmachine and vice versa.
  82. The use of external stops the looping alias problem which would
  83. otherwise occur. 
  84. .Ip "Return of Contents"
  85. Return of contents is now supported. This is a side effect and part of
  86. the work on routing of delivery reports.
  87. .Ip "Use of pepsy"
  88. Use of the PEPSY ASN.1 compiler rather than PEPY/POSY is now used in
  89. many places. This makes for smaller binaries and much quicker
  90. compilation. 
  91. .Ip "ISODE \*(Iv"
  92. PP \*(Pv is aligned to ISODE \*(Iv. It will not work under ISODE \*(Il.  If
  93. you are using the \*(Pv release you should be using ISODE \*(Iv. It should
  94. however work under ISODE \*(Ii. 
  95. .Ip "Tailor file"
  96. There have been many changes to the tailor file. The introduction of
  97. several new variables and the splitting up of header and body part
  98. types. These are
  99. .sp
  100. .in +5
  101. .nf
  102. .ta +\w'queuestruct\0\0'u
  103. dap_user    Directory username for DS lookups
  104. dap_passwd    Directory Passwd for same
  105. fsync    disable use of fsync(2)
  106. headertype    list of headers c.f. bodypart
  107. queuestruct    use hierarchical queue structure
  108. submit_addr    call submit over network
  109. diskuse        limit the disk space consumed by PP
  110. .fi
  111. .in -5
  112. .sp
  113. Channel tailoring also has a number of new variables
  114. .sp
  115. .in +5
  116. .nf
  117. .\" .ta +\w'bad-sender-policy\0\0'u
  118. drchan    replaces old outchan
  119. hdrin    headers inbound
  120. hdrout    headers outbound
  121. ininfo    inbound channel info
  122. inadr    inbound channel addr type
  123. insubadr    inbound channel sub address type
  124. intable    inbound channel table
  125. key    give alternative names to channel
  126. mtatable    list of known mtas for channel binding
  127. outinfo    outbound channel info
  128. outsubadr    outbound channel sub address
  129. outtable    outbound channel table
  130. solo-proc    channel requires address one at a time
  131. bad-sender-policy    set the policy for unroutable senders
  132. check    set the checking mode of the channel
  133. .fi
  134. .in -5
  135. .Ip "Channel pairing"
  136. Channels may now be explicitly paired together. This allows one
  137. definition to specify both an inbound and an outbound channel.
  138. It also allows several logical channels for one inbound protocol by
  139. selecting a channel per MTA.
  140. .Ip "Timezones"
  141. Many more lettered timezones are recognised. This list is ambiguous at
  142. best and numeric forms should really be used except at user
  143. interfaces.
  144. .Ip "Delivery Reports"
  145. Delivery reports are now routed back to their originator. In \*(Lv they
  146. were returned directly down the channel they arrived on. This allows
  147. for one way links in general makes things easier. It also allows
  148. protocol conversion so that, for instance, a delivery report on an
  149. X.400 message may go back via an RFC-822 if that is the only option.
  150. A side effect of this is the channel variable outchan has been renamed
  151. drchan and has different semantics attached to it (see the manual).
  152. .Ip "Header parts"
  153. Separation of headers and bodyparts for each channel. This is mainly a
  154. syntactic change but will allow more flexibility later. The upshot is
  155. you may need both bptin/bptout and hdrin/hdrout types in channel definitions.
  156. .Ip "Local delivery"
  157. The local channel table (ch.local) has had a change of syntax. The old
  158. format should still work, but the new format (which is key=value)
  159. based allows much more flexibility and setting of options for mail
  160. managers.
  161. .Ip "MTA Console"
  162. The MTA Console has been changed to show more statistics and has a new
  163. heuristics for showing just channel and MTA summary information. This
  164. is useful for very large queues. 
  165. .Ip "Line Console"
  166. Two line based console programs have been provided.
  167. These give some of the functionality of the MTA console for dumb terminals.
  168. .Ip "Directory lists"
  169. The directory list program has been improved more. It now has several
  170. associated tools to convert file based lists into directory based
  171. lists. There is also a checkup tool.
  172. .Ip "Performance"
  173. Some work has been done on general performance. In general the system
  174. should run slightly faster and have less problems with large queues.
  175. .Ip "X.400(88) OIDs"
  176. One of the X.400(1988) object identifiers was incorrect. Originally
  177. the code used the object identifier designated in the Blue Book. It now
  178. uses the one given in the implementors guide.
  179. .Ip "Mail 11"
  180. Our thanks must go to Nigel Titley of British Telecom for the donation
  181. of a Decnet Mail-11 channel. This allows interworking with DECNET and PP.
  182. .Ip "G3Fax channel"
  183. A skeleton outbound G3 Fax channel is included. 
  184. There are currently two drivers written using this skeleton, one for
  185. the Fujitsu dexNet200 modem and one for the Panasonic SystemFax 250 machine.
  186. These channels enable PP to send appropriately encoded messages via fax.
  187. There are a couple of reformatter filters which convert an
  188. hdr.822 to a fax coverpage and an ia5 bodypart to a g3fax bodypart.
  189. These reformatters produce X.400 g3fax bodyparts and so are general
  190. use and are not dependent on any fax machine.
  191. .Ip "Splitter Channel"
  192. A Splitter channel is included.
  193. This channel together with the presence of solo-proc=yes in channel
  194. entries in the tailor file enables exclusive processing for specified
  195. recipients. This was introduced for the fax reformatter channels.
  196. .Ip "Address Parsing"
  197. The address parsing code has been restructured extensively. This
  198. should be more efficient in many cases.
  199. .Ip "X.400 Extensions"
  200. X.400(88) address extensions are now recognised.
  201. .Ip "X.400 addresses"
  202. Address parsing recognises A as ADMD and P as PRMD in RFC1148 encoded
  203. X.400 addresses. These are converted to the form given in RFC1148.
  204. .Ip "Multi level queue"
  205. For very large system (queues in excess of about 4000 messages) a
  206. multi-level queue can be used. if this is in effect messages are
  207. placed at random in subdirectories of the main queue to reduce the
  208. time required by the system to locate files.
  209. .Ip "Authorisation Warnings"
  210. Authorisation warnings are now implemented. If a message fails
  211. authorisation, a warning can be optionally sent to the originator
  212. and/or the recipient.
  213. .Ip "Delayed delivery warning"
  214. Warnings of delays in delivery are now sent to the originator of the message
  215. if the message cannot be delivered in a timely fashion.
  216. .Ip "Submit daemon"
  217. Submit can be run as a daemon in addition to its normal directly
  218. executed form. This may give performance improvements for inbound
  219. messages.
  220. .Ip "administrator assigned alternate recipient"
  221. The system manager can direct bad address to a default
  222. mailbox, where numerous actions may be attempted (such as returning
  223. helpful messages about approximate matchings etc.)
  224. .Ip "X.400(88) downgrading"
  225. A filter to downgrade X.400(88) P2 headers to X.400(84) P2 headers has
  226. been provided.
  227. Similarly downgrading of P1 is done in the appropriate channels.
  228. This new filter may also be used to normalise OR addresses in these headers.
  229. .Ip "Body part support"
  230. Support of a number of different body types, including ISO-6937,
  231. ISO-8859, and T.61 character sets.
  232. .Ip "New queue format"
  233. A new queue format has been introduced. We believe this will give
  234. greater reliability and flexibility. There are now no special
  235. subdirectories of the queue, everything is directly under the queue
  236. directory. There is a utility to convert the old format into the new
  237. format (Tools/tables/compat/que_o2n).
  238. New format for the internal structure of the message queue has also
  239. been added in a backwards compatible way.
  240. .Ip "ckadr"
  241. ckadr no longer guesses which format of addressing an address is (x400
  242. or rfc822).
  243. Explicit choice should be made via the -x and -r flags (-r is default)
  244. It also no longer checks for UK domain ordering by default i.e. will only
  245. identify US domain ordering).
  246. Checking for UK ordering can be done via the -b flag.
  247. .Ip "Disk checking"
  248. Submit can be tailored to check the amount of free space available
  249. on disk and not submit messages if this is below some threshold. This
  250. is not supported on all systems.
  251. .Ip "Control of header type"
  252. The specification of a nondefault header type in the inbound channel will
  253. override the default header types such as hdr.822 and hdr.p2.
  254. This will enable a site to minimise the header
  255. manipulation/normalisation done.
  256. .Ip "Bad senders"
  257. The system manager can control the policy for dealing with bad senders
  258. on an inbound channel basis.
  259. .Ip "X.400(88) Extensions"
  260. X.400(88) O/R Address extensions have been implemented and are useable
  261. for routing.
  262. .Ip "loc_dom_mta, loc_dom_site"
  263. Previously these two values were magically recognised as local when
  264. normalising and routing RFC 822 addresses.
  265. This magic has been removed and now you need explicit entries for
  266. these in the domain table
  267. .Ip "redirection history"
  268. X.400 redirection history is now supported.
  269. This shows up a bug in PP 5.* which may cause PP 5.* MTA to break when
  270. interworking over x400 with a PP 6.0 MTA.
  271. Note that aliases are implemented as redirects.
  272. .Ip "table overrides"
  273. Tables may been overriden by explicit key/value pairs given in the
  274. tailor file. 
  275. .NH
  276. Upgrade path
  277. .PP
  278. This is the basics of how to upgrade from PP \*(Lv to \*(Pv.
  279. .Ip "Compile"
  280. Compile pp-\*(Pv and install.
  281. .Ip "domain table"
  282. Convert the domain table into the new format. There are some tools
  283. under Tools/tables/compat to aid in this, but you may want to rethink
  284. how you generate these a little. This is the major change in this
  285. version.
  286. Also check that the relevant entries for loc_dom_site and loc_dom_mta
  287. are present in the domain table as they are no longer magically recognised.
  288. .Ip "alias table"
  289. This should be altered into the new format. The conversion routine in
  290. Tools/tables/compat may help again.
  291. .Ip "local table"
  292. This should be backwards compatible, but you may want to change to the
  293. new format anyway.
  294. .Ip "Queue"
  295. Any files in the queue should be converted to the new format. This can
  296. be done by the following:
  297. .DS 
  298. .../Tools/tables/compat/que_o2n ..../queue
  299. .DE
  300. .Ip "Tailoring"
  301. Change the tailor file to use the new keys and values.
  302. .Ip "Checkup"
  303. Run ckconfig and see that everything is sensible.
  304. .Ip "restart"
  305. Rebuild the database and restart.
  306.  
  307.